home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 23 Geos Applications / GETPIT.ARK / GETMAC.DOC < prev    next >
Text File  |  1987-05-28  |  5KB  |  111 lines
  1.               Conversion of Packit-compressed Macpaint pictures.
  2.  
  3.  
  4.     This document will explain the use of the files in this ARK file in
  5. preparing compressed Macpaints for conversion to geoPaint, or other CBM graphic
  6. formats.
  7.  
  8. Requirements:
  9. C128 with current CP/M system
  10. Mac Attack (LIB 13 MA2V12.BIN), or other Mac->C= converter
  11. CP/M supported disk device large enough to hold .PIT file and component files
  12.  
  13. Contents:
  14. UNPIT.COM - unPackit program
  15. UNPIT.DOC - Doc for UNPIT
  16. UNPIT.C   - C source for UNPIT, dialect unknown
  17. C128LOAD.COM - CP/M to CBM transfer utility
  18. C128LOAD.DOC - Doc for C128LOAD
  19. GETMAC.DOC - this file
  20.  
  21.     UNPIT and C128LOAD are PD CP/M programs, and were not written by me.
  22.  
  23. UNPIT:
  24.     UNPIT is a general CP/M program for uncompressing Macintosh files stored
  25. with Packit II format.  It should work correctly with Packit III files,
  26. assuming they have not been password protected.  It is reasonable to assume
  27. that the vast majority of BBS and commercial network files will not have any
  28. password protection.  It is unknown whether or not this program can handle
  29. Packit I format files, which were not compressed.  It does not work with
  30. Stuffit-compressed files, commonly stored with a .SIT extension.
  31.  
  32. C128LOAD:
  33.     C128LOAD is a rather ingenious C128-specific CP/M program for transferring
  34. CP/M files to C= disks.  It loads the CP/M file into Bank 1 memory.  The user
  35. then immediately CTRL-Enter's out of CP/M, enters MONITOR mode, and saves the
  36. appropriate area of memory to disk.  While this places an absolute restriction
  37. on the file size, it means that the file can be saved to any device supported
  38. by the 128.  It is, of course, only possible to save one file per iteration of
  39. this cycle.  If many files are to be transferred, many boots and exits of CP/M
  40. will be required.  Construction of a boot disk for this purpose is advised.
  41.  
  42.  
  43. The procedure:
  44.  
  45.     1.  Download a Packit-compressed file to a CP/M disk, using whatever
  46. technique works best for you.
  47.  
  48.     2.  From CP/M, unpack the file.  Command syntax is:
  49.  
  50.               UNPIT -D ufn
  51.  
  52.     Unpit does not accept ambigous file names.  It does not support any query
  53. of the contents of the .PIT file, nor any partial extractions.  It will
  54. attempt to extract all contents of the .PIT.  Be sure your disk has enough
  55. free space to permit this.  If available, a 1581 is suggested.
  56.     The -D parameter will cause the program to extract only the "data fork" of
  57. each file, and to not translate CRs to CR-LF pairs.  The "resource fork" is of
  58. no value to you.
  59.  
  60.     3.  C128LOAD a component file.  The starting address will always be 1C00.
  61. Note the ending address.  Note also that, although these are Bank 1 addresses,
  62. the program's author has chosen not to preface them with the Bank number.
  63.  
  64.     4.  Place a formatted C= disk, with no boot sector, in drive 8, and
  65. CTRL-Enter out of CP/M.  This procedure will not disturb the contents of the
  66. area of memory used for the file, nor will it destroy the contents of the REU
  67. CP/M disk, if used.
  68.  
  69.     5.  Press F8 to enter the MONITOR.
  70.  
  71.     6.  Save the file.  If the starting address reported by C128LOAD was 1C00
  72. and the ending address was 7A80, and the desired file name was MACPIC.DAT,
  73. the command would be:
  74.  
  75.               S "MACPIC.DAT",8,11B82,17A80
  76.  
  77.     The reason for the unusual start address is as follows.  UNPIT strips off
  78. the 128-byte Macbinary header that the Mac->C= converters expect to find at the
  79. beginning of a .BIN type Macpaint download.  The address 11B82 is 126 bytes
  80. before the start of the Macpaint data placed in memory by C128LOAD.  Using the
  81. MONITOR S function will cause the first two bytes of the saved file to be the
  82. load address.  These two bytes, plus the 126 bytes before the data, will
  83. function as a garbage Macbinary header, which will be skipped by whatever
  84. conversion program you are using.
  85.  
  86.     7.  Type X to exit the MONITOR.
  87.  
  88.     8.  Repeat steps 1 - 7 as needed.
  89.  
  90.     9.  Convert the files to your desired format.
  91.  
  92.    10.  I am unaware of any means of returning to CP/M from GEOS without
  93. turning off the computer.
  94.  
  95.  
  96. Ed Flinn                  - 09/11/88
  97. revised                   - 03/30/89
  98. revised for Mac Attack II - 11/13/89
  99. minor revision            - 03/25/90
  100.  
  101. addendum:  For those with access to an MS-DOS machine.
  102.  
  103.     Primarily for the use of VCO users, there are Unpackit and Unstuffit
  104. utilities available for MS-DOS machines.  To the best of my recollection, the
  105. MS-DOS Unpackit utility does not strip the Macbinary header, so the file can be
  106. processed as-is.  The MS-DOS unStuffit utility produces a file with a different
  107. header than the Unpack utilities.  With the advent of Joe Buckley's Mac Attack
  108. II, which supports two header sizes, it became practical to convert these to
  109. geoPaint.  This program also permits the conversion of geoPaint files _to_
  110. Macpaint format.
  111.